Mapas Interativos com Python e Folium

Blocos fundamentais do Folium

• folium.Map: define centro, zoom, tiles e comportamento geral do mapa.
• Elementos de overlay: marcadores, linhas, polígonos, GeoJSON ou choropleths que vão sobre o mapa base.
• Camadas: TileLayer, FeatureGroup e LayerControl permitem alternar informações rapidamente.
• Métodos de visualização: .show_in_browser() abre o mapa em um arquivo temporário; .save() gera uma versão definitiva; .get_root().render() retorna o HTML em string.

Ajustando a janela do mapa

O recorte inicial influencia a mensagem do mapa. Ajuste centro, zoom e limites para orientar o olhar de quem consulta a visualização.

• zoom_start: aproximação inicial. Use 4–6 para visão regional, 12–14 para cidades, 17+ para quadras.
• min_zoom e max_zoom: impedem que o usuário se afaste ou aproxime demais.
• max_bounds: define recorte geográfico obrigatório, útil para delimitar municípios ou unidades de conservação.
• width/height e control_scale: controlam dimensões e exibem barra de escala.

mapa_com_controles = folium.Map(
    location=[-27.6, -48.55],
    zoom_start=12,
    min_zoom=10,
    max_zoom=17,
    max_bounds=[[-27.75, -48.75], [-27.45, -48.35]],
    control_scale=True,
    tiles='CartoDB positron'
)

mapa_com_controles.show_in_browser()

Se o mapa ficar restrito demais, amplie os limites do max_bounds ou ajuste o zoom máximos. Teste em diferentes tamanhos de tela.

Marcadores, popups e tooltips

Marcadores são ideais para destacar pontos de interesse. Você pode construir o marcador em uma linha ou configurá-lo previamente para reutilizar em loops.

mapa = folium.Map(location=[-27.59397, -48.54235], zoom_start=13)

folium.Marker(
    location=[-27.59397, -48.54235],
    popup=folium.Popup('IFSC - Câmpus Florianópolis', max_width=250),
    tooltip='Clique ou toque para saber mais'
).add_to(mapa)

folium.Marker(
    location=[-27.5998, -48.5483],
    popup='Terminal Rita Maria',
    tooltip='Terminal rodoviário'
).add_to(mapa)

mapa.show_in_browser()

Camadas base e sobreposições

Permita que a pessoa usuária alterne entre diferentes representações e ative informações auxiliares como limites ou pontos temáticos.

mapa = folium.Map(location=[-27.59, -48.54], zoom_start=13)

# Camadas de fundo (basemaps)
folium.TileLayer('OpenStreetMap', name='Ruas').add_to(mapa)
folium.TileLayer(
    tiles='https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}',
    attr='Esri',
    name='Satélite'
).add_to(mapa)
folium.TileLayer('Stamen Terrain', name='Relevo').add_to(mapa)

# Camada temática adicional usando GeoJSON
limite_ilha = folium.GeoJson(
    data='arquivos/limite_florianopolis.geojson',
    name='Limite municipal',
    style_function=lambda feat: {
        'color': '#1B5E20',
        'weight': 2,
        'fillOpacity': 0
    }
)
limite_ilha.add_to(mapa)

folium.LayerControl(collapsed=False).add_to(mapa)
mapa.show_in_browser()

O arquivo GeoJSON deve estar na mesma pasta ou acessível via caminho relativo. Ajuste collapsed para True se quiser um controle mais compacto.

Balneabilidade das praias

Vamos construir um mapa temático que colore cada praia conforme a situação de balneabilidade divulgada pelo órgão ambiental. Usaremos o CSV disponível em arquivos/Pontos.csv.

Passo 1 · Conferindo os dados

Antes de mapear, abra o CSV em um editor ou notebook e verifique se os campos Longitude e Latitude estão numéricos e com o separador decimal correto.

Praia,Latitude,Longitude,Situação
Praia da Barra,-27.600218,-48.573928,Boa
Praia Mole,-27.605612,-48.448782,Regular
Praia dos Ingleses,-27.432509,-48.399489,Ruim
Praia do Campeche,-27.658957,-48.489882,Boa
Praia do Santinho,-27.409855,-48.368907,Ruim
Praia da Joaquina,-27.637142,-48.436796,Regular
Praia de Canasvieiras,-27.432064,-48.500224,Boa
Praia do Pântano do Sul,-27.739187,-48.502771,Regular

Passo 2 · Script em Python

Use Pandas para ler o arquivo, calcule a média das coordenadas para centralizar o mapa e mapeie as categorias para cores e ícones.

import folium
import pandas as pd

df = pd.read_csv('arquivos/Pontos.csv')
centro = [df['Latitude'].mean(), df['Longitude'].mean()]

cores = {
    'Boa': ('green', 'smile-o'),
    'Regular': ('orange', 'meh-o'),
    'Ruim': ('red', 'frown-o')
}

mapa = folium.Map(location=centro, zoom_start=12)

for _, linha in df.iterrows():
    situacao = linha['Situação']
    cor, icone = cores.get(situacao, ('gray', 'question'))
    folium.Marker(
        location=[linha['Latitude'], linha['Longitude']],
        popup=f"{linha['Praia']} — Situação: {situacao}",
        tooltip=linha['Praia'],
        icon=folium.Icon(color=cor, icon=icone, prefix='fa')
    ).add_to(mapa)

folium.LayerControl().add_to(mapa)
mapa.show_in_browser()
print('Mapa das praias aberto no navegador padrão.')

Ajuste as palavras das categorias para corresponder exatamente ao CSV. Se novas classificações surgirem, atualize o dicionário cores.

Próximos passos com plugins

Amplie a experiência com extensões já incluídas no Folium.

import folium
from folium.plugins import DragMarker

mapa = folium.Map(location=[-27.59, -48.54], zoom_start=14)

DragMarker(
    [-27.59397, -48.54235],
    popup='Arraste-me para a posição correta!'
).add_to(mapa)

mapa.show_in_browser()

import folium

html_popup = """
    
Ponte Hercílio Luz
    

    
A ponte é um cartão-postal de Florianópolis.
    Saiba mais
"""

iframe = folium.IFrame(html_popup, width=280, height=280)
popup = folium.Popup(iframe, max_width=280)

mapa = folium.Map(location=[-27.5930, -48.5615], zoom_start=16)
folium.Marker(
    location=[-27.5930, -48.5615],
    popup=popup,
    tooltip='Clique para ver!'
).add_to(mapa)

mapa.show_in_browser()

import folium
from folium.plugins import HeatMap
import random

mapa = folium.Map(location=[-27.59, -48.54], zoom_start=12)

pontos = [
    [-27.59 + (random.random() - 0.5) * 0.1,
     -48.54 + (random.random() - 0.5) * 0.2]
    for _ in range(100)
]

HeatMap(pontos).add_to(mapa)
mapa.show_in_browser()

Fechamento

Você aprendeu a transformar dados tabulares e geoespaciais em mapas navegáveis, com controle total sobre zoom, camadas e marcadores. Dominar Folium significa comunicar resultados sem depender de softwares pesados ou longas instruções para o público final.

Continue combinando Folium com bibliotecas como GeoPandas e Shapely para análises espaciais mais complexas — os mapas interativos serão a vitrine ideal para seus insights.